home *** CD-ROM | disk | FTP | other *** search
/ Amiga Collections: Franz PD / Franz PD Disk #315 (1994-03)(Rhein-Sieg-Soft).zip / Franz PD Disk #315 (1994-03)(Rhein-Sieg-Soft).adf / wbgames / WBGames.doc < prev    next >
Text File  |  1993-03-20  |  15KB  |  343 lines
  1. SHORT: Tiny Tetris,Columns,etc. (6 games) for any public screen
  2.  
  3.                                
  4.                                 WBGames
  5.                           by Marat Fayzullin
  6.                           ( fms@wam.umd.edu )   
  7.                              (C) FMS 1993      
  8.  
  9.                                3/20/1993
  10.  
  11.  
  12.   It is the seventh edition of WBGames. It includes:
  13.                              
  14.                              WBTetris       1.7
  15.                              WBColumns      1.6
  16.                              WBMineSweeper  1.6
  17.                              WB15           1.4
  18.                              WBBoxMan       1.4
  19.                              WBBoulder      1.1
  20.  
  21.     I. History:
  22.  
  23. WBGames 1.7:
  24.   1. New game called WBBoulder is added to the package. It
  25.      is a clone of BoulderDash. Usage and editing of levels 
  26.      is similar to WBBoxMan. The Boulder.DAT file contains
  27.      6 levels only. SOMEBODY, MAKE MORE LEVELS!
  28.   2. I took the level selection out of WB15. It is not needed
  29.      in there anyway. I also changed "End of Game" message
  30.      in WB15.
  31.   3. All games are rewritten so that they better adapt to
  32.      different screen and window types.
  33.   4. I changed several things so that next versions can be
  34.      easily adapted for both 2:1 (640*200) and 1:1 (640*400)
  35.      screens. This capability isn't used yet, but it will be
  36.      used in the next release!
  37.   5. In both WBBoulder and WBBoxMan the "Level" menu is used
  38.      to browse through the levels, not to set some certain level
  39.      number.
  40.   6. I changed the icon for WBBoxMan executable.
  41.   7. My E-Mail address has changed (notice this!).
  42.           
  43. WBGames 1.6:
  44.   1. All games were recompiled with the updated C compiler
  45.   2. Prevoius versions didn't check the height of the window
  46.      title bar. So, if you try to use something like Times 24
  47.      as the title font, old WBGames looked ugly.
  48.   3. WBGames 1.5 didn't open Topaz 8 font in order to use it.
  49.      I assume that it is always opened anyway, but being nice
  50.      I added OpenFont()/CloseFont() calls ( On other hand, who
  51.      knows, what CBM will come up with... ).
  52.   4. The look of the games has improved ( Well, it CHANGED. ).
  53.   5. WBBoxMan now counts number of pushes, not the number of
  54.      arrow movements.  
  55.   6. I added one more tooltype to all of the games: PAUSED.
  56.      It defines if the game will be paused on startup.
  57.   7. Because of frequent updates, I put the date of the last
  58.      modification in the title bar.
  59.   8. After I found ASokoban by P.J.Christias I stole couple of
  60.      ideas from it, including the set of the mazes. This set is
  61.      called Sokoban.Dat. Sorry for this, but ASokoban looks so
  62.      nice...  
  63.   9. Manual has improved one more time ( Don't say it is still
  64.      unreadable! ). So, the last version of the manual didn't
  65.      tell you that you can use SHOWNEXT tooltype in the Tetris
  66.      and Columns.
  67.  10. Number of levels in BoxMan isn't limited anymore. You may
  68.      have hundreds of levels in a single file, if you desire.
  69.      Just remember, that any time when BoxMan can't open the
  70.      level, it will begin the game from the level 1 assuming
  71.      that there are no more levels in this data file.  
  72.   
  73. WBGames 1.5:  
  74.   1. There was a terrible bug in all previous WBGames. It can be
  75.      seen in the old MineSweeper: after you try to resize its
  76.      window, Intuition will update its Close/Zoom/Resize/TopBottom
  77.      gadgets every time you use any menu (even if it is the menu
  78.      of different program). Doesn't look dangerous, does it?
  79.      Nevertheless, this thing is capable of causing gurus and
  80.      screwing up the system.
  81.   2. WBColumns was starting with the same piece every time you ran
  82.      it. Now it selects the random piece.
  83.   3. I'm terribly sorry for the random number generator I use.
  84.      The rand() function in my C compiler is extremely bad; it
  85.      causes all those strange mines layouts in MineSweeper and it
  86.      also doesn't mix the pieces in the WB15 enough. In the new
  87.      versions I have improved it a little, but don't expect good
  88.      randomization.        
  89.   4. WBTetris and WBColumns are FASTER now! Yes, level 5 became too
  90.      fast for me and I went to the level 4!
  91.   5. ONE BIG IMPROVEMENT:
  92.      WBGames are still WB-Games, but now they can be played on ANY
  93.      public screen. You can also change window coordinates, levels
  94.      and field sizes on startup. Read the rest of the manual for 
  95.      instructions!
  96.   6. Another, quite obvious improvement: I have a tradition to add a
  97.      new game to each edition. This time it is BoxMan - the Sokoban
  98.      (a.k.a. Boxxle) clone. Unfortunately, there are only 7 levels 
  99.      ready. If you need more - feel free to modify Levels.Dat file.
  100.      Just don't forget to send your masterpiece to me, I also like
  101.      to play this game!
  102.      
  103.      
  104.      
  105.   II. Copyright
  106.   
  107.   You can use the games as long as you want and don't make any profit
  108. from it. If you feel obliged (which is unlikely) or want MOST RECENT
  109. VERSIONS of WBGames, you have to send me $15 US. I can also send the
  110. SOURCES and CISTOMIZED VERSIONS (just write me what you want to be
  111. changed). If you aren't interested in getting the newest versions of
  112. WBGames - use those you have for free, I don't mind, but I change the
  113. package and add new games every 2-3 weeks. C source codes of these
  114. games alone are worth those $15. 
  115.  
  116.         To register WBGames and get newest versions of them:      
  117.  
  118.         Send $15 US to:
  119.         
  120.                       Marat Fayzullin
  121.                  8770 Cloudleap Court #24
  122.                  Columbia, Maryland 21045
  123.                             USA        
  124.          
  125.         Don't forget: You pay those miserable $15 for the 6
  126.                       great games!  
  127.  
  128.  
  129.  
  130.  
  131.   III. Instructions
  132.   
  133.   All games have similar interfaces. So, you can stop the game (Game|Stop
  134. menu option), start it (Game|Start option), begin a new game (Project|
  135. New option), and, obviously, quit the game (Project|Quit). There is also
  136. level selection (Game|Level) and "About" option (Project|About).
  137.  
  138.   Here are the individual manuals:
  139.   
  140.   1. WBTetris
  141.                    Keys:                             Scoring:
  142.   [LEFT ARROW]  - move the piece to the left   |  30 for 1 line 
  143.   [RIGHT ARROW] - move the piece to the right  |  60 for 2 lines
  144.   [UP ARROW]    - turn the piece               |  90 for 3 lines 
  145.   [DOWN ARROW]  - speed up the falling         |  100 for 4 lines
  146.   [SPACE]       - drop the piece               |
  147.   
  148.   ToolTypes:
  149.   SCREEN=<PubScreenName> - the name of public screen you want to
  150.                            play the game on
  151.   LEVEL=<1-5>            - the level number
  152.   X=<XCoordinate>        - the coordinates of the left-upper 
  153.   Y=<YCoordinate>          corner of the window
  154.   PAUSED=<ON>/<OFF>/<YES>/<NO>   - Pause/Unpause game on startup
  155.   SHOWNEXT=<ON>/<OFF>/<YES>/<NO> - Show/Hide next piece on startup
  156.   
  157.   2. WBColumns
  158.                    Keys:                             Scoring:
  159.   [LEFT ARROW]  - move the piece to the left   |  30 for each row at the
  160.   [RIGHT ARROW] - move the piece to the right  |     first turn
  161.   [UP ARROW]    - shift the colors             |  60 for each row at the  
  162.   [DOWN ARROW]  - speed up the falling         |     second turn
  163.   [SPACE]       - drop the piece               |           ...
  164.   [LEFT AMIGA]  - turn the piece               |
  165.  
  166.   ToolTypes:
  167.   SCREEN=<PubScreenName> - the name of public screen you want to
  168.                            play the game on
  169.   LEVEL=<1-5>            - the level number
  170.   X=<XCoordinate>        - the coordinates of the left-upper 
  171.   Y=<YCoordinate>          corner of the window 
  172.   PAUSED=<ON>/<OFF>/<YES>/<NO>   - Pause/Unpause game on startup
  173.   SHOWNEXT=<ON>/<OFF>/<YES>/<NO> - Show/Hide next piece on startup
  174.  
  175.   3. WBMineSweeper
  176.   
  177.   Keys:
  178.   [LEFT MOUSE BUTTON]  - open the square 
  179.   [RIGHT MOUSE BUTTON] - mark/unmark the square
  180.  
  181.   "Level" means the density of mines!
  182.  
  183.   ToolTypes:
  184.   SCREEN=<PubScreenName> - the name of public screen you want to
  185.                            play the game on
  186.   LEVEL=<1-5>            - the level number
  187.   X=<XCoordinate>        - the coordinates of the left-upper 
  188.   Y=<YCoordinate>          corner of the window 
  189.   XSIZE=<8-30>           - the field sizes
  190.   YSIZE=<8-20>
  191.   PAUSED=<ON>/<OFF>/<YES>/<NO>   - Pause/Unpause game on startup
  192.   
  193.   4. WB15
  194.   
  195.   Keys:  
  196.   [LEFT MOUSE BUTTON] - shift the pieces
  197.  
  198.   ToolTypes:
  199.   SCREEN=<PubScreenName> - the name of public screen you want to
  200.                            play the game on
  201.   X=<XCoordinate>        - the coordinates of the left-upper 
  202.   Y=<YCoordinate>          corner of the window
  203.   PAUSED=<ON>/<OFF>/<YES>/<NO>   - Pause/Unpause game on startup
  204.   
  205.   5. WBBoxMan
  206.   
  207.   Start:
  208.   From CLI: BoxMan <FileName> [ToolTypes] where the file
  209.             FileName contains the levels you want to play at.
  210.   From WB:  Use BoxMan as a tool for a file containing the
  211.             levels. As example, I included a couple of these
  212.             files.
  213.  
  214.   Keys:  
  215.   [LEFT ARROW]  - move the arrow to the left
  216.   [RIGHT ARROW] - move the arrow to the right
  217.   [UP ARROW]    - move the arrow up
  218.   [DOWN ARROW]  - move the arrow down
  219.  
  220.   The goal is to put all small boxes on their places. Remember
  221.   that you can push only one box! This game needs a name of the
  222.   file containing the levels. Otherwise, it will try to open the
  223.   file called "BoxMan.Dat". You can change the levels and create
  224.   new ones editing data files. Their format is self explanatory:
  225.   just type "more Levels.Dat" to see those 7 levels I made, and
  226.   you will get it! Also, take a look at Sokoban.Dat.     
  227.  
  228.   Data file format: (for those who can't figure it out)
  229.   ----------------------------------------------------------
  230.   : Name of Level        The map uses these characters:
  231.      Level Map           [.] - place for the box
  232.      ...                 [#] - wall
  233.                          [*] - box
  234.   : Next Level                         
  235.      ...                 [@] - starting position
  236.   ---------------------------------------------------------- 
  237.   Notice that if you don't enter the level correctly, game
  238.   will display "End of Game?" message and reset to the first
  239.   level. The most common error is omission of the starting
  240.   position from the map.
  241.  
  242.   ToolTypes:
  243.   SCREEN=<PubScreenName> - the name of public screen you want to
  244.                            play the game on
  245.   LEVEL=1...             - the level number
  246.   X=<XCoordinate>        - the coordinates of the left-upper 
  247.   Y=<YCoordinate>          corner of the window 
  248.   PAUSED=<ON>/<OFF>/<YES>/<NO>   - Pause/Unpause game on startup
  249.  
  250.   6. WBBoulder
  251.   
  252.   Start:
  253.   From CLI: Boulder <FileName> [ToolTypes] where the file
  254.             FileName contains the levels you want to play at.
  255.   From WB:  Use Boulder as a tool for a file containing the
  256.             levels.
  257.  
  258.   Keys:  
  259.   [LEFT ARROW]  - move the arrow to the left
  260.   [RIGHT ARROW] - move the arrow to the right
  261.   [UP ARROW]    - move the arrow up
  262.   [DOWN ARROW]  - move the arrow down
  263.  
  264.   The goal is to collect all crystals and not get caught under the
  265.   boulders. Falling crystals or boulders kill you. This game needs
  266.   a name of the file containing the levels. Otherwise, it will try
  267.   to open the file called "Boulder.Dat". You can change the levels
  268.   and create new ones editing data files. Their format is self
  269.   explanatory: just type "more Boulder.Dat" to see those 6 levels I
  270.   made, and you will get it!     
  271.  
  272.   Data file format: (for those who can't figure it out)
  273.   ----------------------------------------------------------
  274.   : Name of Level        The map uses these characters:
  275.      Level Map           [.] - terrain
  276.      ...                 [#] - wall
  277.                          [o] - boulder
  278.   : Next Level           [*] - crystal
  279.      ...                 [@] - starting position
  280.   ---------------------------------------------------------- 
  281.   Notice that if you don't enter the level correctly, game
  282.   will display "End of Game?" message and reset to the first
  283.   level. The most common error is omission of the starting
  284.   position from the map.
  285.  
  286.   ToolTypes:
  287.   SCREEN=<PubScreenName> - the name of public screen you want to
  288.                            play the game on
  289.   LEVEL=1...             - the level number
  290.   X=<XCoordinate>        - the coordinates of the left-upper 
  291.   Y=<YCoordinate>          corner of the window 
  292.   PAUSED=<ON>/<OFF>/<YES>/<NO>   - Pause/Unpause game on startup
  293.  
  294.  
  295.   All games were written for HIRES NON-INTERLACED SCREEN, so all pictures
  296. have X:Y ratio 2:1. Because of this, games won't be looking so nice on the
  297. different type of screen (640:400, for example), but you can use the 
  298. screen with the ratio near to 640:200. For example 800:250 would be OK.
  299. Of course, if you use 640:200 screen to open the games on, you won't have
  300. this problem at all. Next version will probably include the bitmaps with
  301. 1:1 ratio.
  302.   WBColumns also needs not less than 8 colors to work. In fact, its icon
  303. is done in 8 colors. Other games work with first four standard colors.
  304.  
  305.  
  306.   IV. Known Bugs:
  307.    
  308.       1. BoxMan and Boulder sometimes don't draw entire maze
  309.          on startup, especially if it is the large maze and
  310.          machine is too busy. They also "forget" to display
  311.          info line in this case. I don't know why it happens.
  312.          If you get something like this, select "New" from the
  313.          menu and everything will get normal.
  314.       2. I suspect that Columns sometimes doesn't collapse
  315.          lines right. I can not prove it, because as soon as I
  316.          react the line is already gone. If you notice something
  317.          like this, send me a letter.
  318.       3. Some of WBGames may cause Enforcer hits. If you notice
  319.          such hit, tell me about it.
  320.  
  321.  
  322.   V. Where to send bug-reports, questions, advices and MONEY:
  323.  
  324.                E-Mail: fms@wam.umd.edu
  325.  
  326.                             or
  327.  
  328.                      Marat  Fayzullin
  329.                  8770 Cloudleap Court #24
  330.                  Columbia, Maryland 21045
  331.                             USA   
  332.   
  333.            Send $15 and register your WBGames NOW!
  334.                   
  335.  
  336. P.S.: Hey, somebody with A3000/A4000 etc., send me report about
  337.       how WBGames work on these machines! I don't have chance
  338.       to try them on anything else than my rusty A2000.
  339.       
  340. ---------------------------------------------------------------------- 
  341. |  "IBM PC: Just say NO!"   |        Marat Fayzullin  3/20/1993      |
  342. |                           |             fms@wam.umd.edu            |
  343. ----------------------------------------------------------------------